home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 26 / CU Amiga Magazine's Super CD-ROM 26 (1998)(EMAP Images)(GB)[!][issue 1998-09].iso / CUCD / PowerPC / uae-0.8.4 / docs / translated / LIESMICH < prev   
Text File  |  1998-03-15  |  16KB  |  321 lines
  1. [If the rest of this file is incomprehensible to you, that's because it
  2. contains german instructions.]
  3. Für Leute, die englische Texte nicht besonders gut verdauen, sind in dieser
  4. Datei noch einmal die wichtigsten Hinweise zu UAE zusammengefaßt. Die
  5. englische README-Datei enthält wesentlich mehr Information; diese deutsche
  6. Übersetzung ist nur eine Notlösung.
  7.  
  8. UAE steht für Un*x Amiga Emulator, was den Kern der Sache nicht ganz trifft,
  9. da auch Versionen für Mac, DOS, NextStep, BeBox und Amiga verfügbar sind.
  10.  
  11. [Anmerkung: Manche Versionen von UAE, etwa die DOS- und die Mac-Version haben
  12. zusätzliche Readme-Dateien, die Sie ebenfalls lesen sollten, da manche Details
  13. von der Unix-Version abweichen.]
  14.  
  15. Lizenz
  16. ======
  17.  
  18. UAE unterliegt der GNU General Public License, die in der Datei "COPYING"
  19. im Hauptverzeichnis dieses Archivs enthalten ist.
  20.  
  21.  
  22. Übersicht
  23. =========
  24.  
  25. UAE emuliert einen A500 mit bis zu 2MB Chipram und 8.5MB Fast-RAM. Die
  26. Emulation ist nahezu vollständig. Ursprünglich wurde UAE für Unix-ähnliche
  27. Systeme (ich selbst benutze Linux) geschrieben, hauptsächlich deswegen, weil
  28. Programmieren unter anderen Betriebssystemen Strafarbeit ist (Fehler=>Absturz).
  29. Die Hard-/Softwarevoraussetzungen für den Betrieb der Unix-Version sind:
  30.   - 8MB RAM, besser 12-16MB
  31.   - ein schneller Prozessor (i486 ist nicht das Gelbe vom Brot)
  32.   - X11, oder SVGAlib unter Linux
  33.   - ein ANSI-C-Compiler, am besten GCC.
  34.   - optional: Die gtk+-Bibliothek, Version 0.99.3 oder höher
  35.  
  36.  
  37. Vorbereitungen
  38. ==============
  39.  
  40. Zugriffe auf das Diskettenlaufwerk können nur über einen Umweg emuliert 
  41. werden, da PCs keine Amiga-Disketten lesen können. UAE verwendet 
  42. "Diskfiles", das sind genaue Abbilder des Inhalts einer Amiga-Diskette. Solche
  43. Diskfiles sind 901120 Bytes groß und können mit dem Tool "transdisk", das UAE 
  44. beiliegt erstellt werden. Um UAE laufenzulassen, benötigen Sie außerdem ein 
  45. Abbild eines Amiga-Kickstart-ROMs. Dieses kann aus Copyrightgründen nicht mit 
  46. UAE vertrieben werden. Es muß mit dem Tool "transrom" erzeugt werden.
  47. Die beiden Programme finden Sie im Unterverzeichnis "amiga". Sie müssen sie
  48. zunächst auf Ihren Amiga kopieren, entweder über ein serielles Nullmodem-Kabel
  49. oder mit Hilfe eines Amiga-Programms wie etwa CrossDOS oder MessyDOS, die es
  50. ermöglichen, PC-Disks mit einem Amiga zu lesen und zu beschreiben. Dieselbe
  51. Methode kann dann selbstverständlich auch benutzt werden, um Amiga-Dateien auf
  52. den PC zu kopieren. CrossDOS ist seit einiger Zeit Bestandteil des
  53. Amiga-Betriebssystems, und MessyDOS ist frei erhältlich (u.a. auf einer 
  54. älteren Fish-Disk, Nummer habe ich vergessen). Beachten Sie, daß in vielen
  55. Amigas nur DD-Laufwerke eingebaut sind, die PC-üblichen HD-Disketten lassen
  56. sich damit nicht verarbeiten.
  57. Wenn Sie die Lösung mit dem Nullmodemkabel benutzen wollen, werden Sie zwei
  58. Terminalprogramme benötigen, sowohl für den PC als auch für den Amiga.
  59. Bitte lesen Sie in den jeweiligen Anleitungen der Programme (etwa CrossDOS 
  60. oder die Terminalprogramme) nach, wie diese Programme zu bedienen sind.
  61. Nachdem Sie transrom und transdisk auf den Amiga kopiert haben, müssen Sie dem
  62. AmigaOS beibringen, daß diese Dateien ausführbare Programme sind. Das
  63. geschieht durch den CLI-Befehl
  64.  
  65.   "protect transrom rwed" (bzw. "protect transdisk rwed")
  66.  
  67. Danach können Sie die Programme aufrufen:
  68.  
  69.   transrom >RAM:kick.rom
  70.   
  71. erzeugt eine 524288 Byte große Kickstart-Datei in der Ramdisk. Diese müssen
  72. Sie auf Ihren PC übertragen und dort in dasselbe Verzeichnis kopieren, in dem
  73. UAE installiert ist.
  74. Mit 
  75.   transdisk >RAM:df0.adf
  76.   
  77. kann die in Laufwerk 0 liegende Diskette in ein Diskettenabbild umgewandelt
  78. werden, welches wiederum in der Ramdisk gespeichert wird. Hierbei kann ein
  79. Problem auftreten, wenn Ihr Amiga wenig Speicher hat (wenn er _sehr_ wenig
  80. Speicher hat, funktioniert schon der obige transrom-Befehl nicht; dann haben
  81. Sie leider Pech gehabt). Sie können die Diskette in mehreren Stücken
  82. übertragen. Eine Amiga-Diskette hat 80 Spuren (0..79); mit den Befehlen
  83.  
  84.   transdisk >ram:df0_1.adf -s 0 -e 19
  85.   transdisk >ram:df0_2.adf -s 20 -e 39
  86.   transdisk >ram:df0_3.adf -s 40 -e 59
  87.   transdisk >ram:df0_4.adf -s 60 -e 79
  88.  
  89. werden vier Teil-Disketten-Abbilder erstellt, (z.B. enthält df0_1.adf gerade
  90. die Spuren 0 bis 19). Es macht natürlich keinen Sinn, die Befehle in obiger
  91. Reihenfolge aufzurufen, Sie sollten immer nur jeweils eine Datei erzeugen, auf
  92. den PC übertragen, aus der Amiga-Ramdisk löschen und dann fortfahren.
  93. Die vier Dateien lassen sich dann auf dem PC wieder zu einer zusammensetzen,
  94. entweder unter DOS mit
  95.  
  96.   COPY /B df0_1.adf+df0_2.adf+df0_3.adf+df0_4.adf df0.adf
  97.  
  98. oder unter Unix:
  99.  
  100.   cat df0_1.adf df0_2.adf df0_3.adf df0_4.adf >df0.adf
  101.  
  102. UAE benötigt die Datei "kick.rom" (524288 Byte) und eine Datei "df0.adf"
  103. (901120 Byte), um etwas Sinnvolles zu tun. Diese müssen im gleichen
  104. Verzeichnis stehen, wie UAE.
  105. Die Datei, die das Kickstartabbild enthält, dürfen Sie nicht weitergeben, da
  106. sie Code enthält, dessen Copyright Commodore-Amiga hält. Ebenso dürfen die
  107. meisten Diskettenabbilder (etwa die Workbench, oder kommerzielle Spiele) nicht
  108. weiterverbreitet werden. Sie dürfen mit UAE nur Software benutzen, für die Sie
  109. das Nutzungsrecht haben.
  110.  
  111.  
  112. Compilierung
  113. ============
  114.  
  115. Die Versionen für Unix, NextStep und BeBox müssen zunächst compiliert werden.
  116. Für die BeBox müssen Sie dafür ins Verzeichnis "src" gehen und
  117.  
  118.   make -f Makefile.Be
  119.   
  120. eingeben, auf anderen Systemen müssen Sie zunächst
  121.  
  122.   configure
  123.  
  124. aufrufen; dieses Skript analysiert Ihr System und sammelt Informationen (aber
  125. im Gegensatz zu MessySoft-Produkten schickt es sie nicht übers Netz an andere
  126. Leute, sondern erstellt nur die Dateien "Makefile" und "sysconfig.h"). Danach
  127. können Sie mit
  128.  
  129.   make
  130.   
  131. UAE compilieren. Am Ende sollte eine ausführbare Datei namens "uae" entstanden
  132. sein. Falls Sie unter Linux die SVGAlib- anstelle der X11-Version benutzen
  133. möchten, geben Sie statt "configure" "configure --with-svgalib" ein.
  134. Sie müssen root sein, um die SVGA-Version starten zu können. Machen Sie UAE
  135. besser nicht suid root, wenn Ihnen an der Sicherheit des Systems gelegen ist,
  136. oder Sie könnten böse Überraschungen erleben.
  137.  
  138.  
  139. Kommandozeilen-Optionen
  140. =======================
  141.  
  142. Die folgenden Paramter können Sie UAE in der Kommandozeile übergeben. Sie 
  143. können häufig benötigte Optionen auch in eine Datei namens "~/.uaerc" (Unix)
  144. oder "uae.rc" (andere) schreiben, diese Datei wird von UAE beim Start
  145. gelesen (und wahlweise am Ende geschrieben).
  146.  
  147. Allgemeine Optionen:
  148.  -h      : Gibt einen Hilfetext aus, der alle Optionen beschreibt.
  149.  -f rate : Bildaufbau-Frequenz einstellen. Je höher "rate" ist, desto
  150.            schneller wird UAE, aber der Bildaufbau ist nicht mehr flüssig,
  151.        sondern abgehackt. Standard ist "-f 1", für manche Programme
  152.        könnte "-f 3" empfehlenswert sein.
  153.  -a      : Keine Erweiterungs"hardware" einbinden. Diese Option schaltet
  154.            die Harddisk- und Fastmem-Emulation aus, ist aber möglicherweise
  155.        für einige Programme nötig.
  156.  -l lang : Tastatur-Sprache auswählen. Für deutsche Tastaturen: "-l de"
  157.  -0 file : "file" wird anstelle von "df0.adf" benutzt, um Laufwerk 0 zu
  158.            emulieren. -1, -2 und -3 funktionieren auch (der Amiga kann bis zu 
  159.        4 Floppylaufwerke haben)
  160.  -r file : "file" wird als Kickstart-ROM-Datei benutzt.
  161.  -J ab   : Legt fest, wie Gameport 0 (a) und Gameport 1 (b) des Amigas
  162.            emuliert werden. Für "a" und "b" können die folgenden Werte
  163.            eingesetzt werden: "0" (Joystick 0), "1" (Joystick 1), "M" (Maus),
  164.        "A", "B", "C" (verschiedene Joystickemulationen auf der Tastatur)
  165.        "A": Zehnerblock (8/4/6/2/0), "B": Cursortasten/Ctrl,
  166.        "C": T/F/H/B/Alt
  167.  -x      : In der X11-Version von UAE macht diese Option den X-Mauszeiger als
  168.            Fadenkreuz unsichtbar. In der SVGAlib-Version schaltet sie die 
  169.        Benutzung eines linearen Framebuffers ab, was die Emulation
  170.        langsamer macht, aber bei Problemen nötig sein könnte.
  171.  -G      : Stellt alle Benutzeroberflächen ab. Nur der Emulator wird
  172.            gestartet.
  173.  -C specs: Gibt an, welche CPU emuliert werden soll. Das erste Zeichen in
  174.            "specs" muss sein: '0' für 68000, '1' für 68010, '2' für 68020
  175.        oder '3' für 68020+68881. Danach kann ein 'c' folgen, für eine
  176.        langsamere aber kompatiblere 68000-Emulation, oder ein 'a' für
  177.        eine 68020-Emulation mit 24-Bit-Adressraum.
  178.  
  179. Externe Hardware emulieren (Drucker, serielle Schnittstelle, Harddisk)
  180.  -M VOLUME:path
  181.  -m VOLUME:path
  182.            Hiermit können Sie ein Verzeichnis Ihrer Festplatte vom Amiga aus
  183.        nutzen. Wenn Sie "-M sound:/usr/amiga/modules" eingeben, wird auf
  184.        der Amiga-Seite eine Festplatte namens "SOUND:" emuliert, deren
  185.        Inhalt sich im Unix-Verzeichnis /usr/amiga/modules befindet.
  186.        Mit -M wird das Verzeichnis schreibgeschützt gemountet.
  187.  -p cmd  : Schaltet die Druckeremulation ein. Sie benötigen den
  188.            Amiga-Postscript-Druckertreiber der Workbench 3.0. Als Parameter
  189.        cmd übergeben Sie den Namen des Programms, das zum Drucken
  190.        gestartet werden soll ("lpr" für die meisten Unix-Systeme), bzw.
  191.        den Namen der parallelen Schnittstelle unter DOS ("PRN").
  192.  -I dev  : Schaltet die Emulation der seriellen Schnittstelle ein. dev gibt
  193.            dabei den Devicenamen an (etwa "/dev/ttyS1" unter Linux)
  194.        Funktioniert noch nicht zuverlässig.
  195.  
  196. Sound-Optionen:
  197.  -S specs: Falls Ihre Version von UAE Sound unterstützt, können Sie hiermit
  198.            einstellen, wie die Soundemulation arbeiten soll. Die "specs"
  199.        bestehen aus mehreren Feldern: "n:stereo:bits:frequenz:min:max"
  200.        n = 0: Keine vernünftige Soundemulation. Diese Einstellung könnte
  201.               in unwahrscheinlichen Fällen inkompatibel sein.
  202.        n = 1: Soundhardware emulieren, aber keinen Sound ausgeben. Diese
  203.               Einstellung kann deutlich langsamer sein als n = 0.
  204.        n = 2: Soundhardware emulieren und Sound ausgeben. Empfohlen.
  205.        n = 3: Soundhardware _exakt_ emulieren. Sie werden keinen 
  206.               Unterschied hören, aber die Emulation kann hierdurch stark
  207.           ausgebremst werden.
  208.        stereo kann entweder 's' oder 'm' sein.
  209.        bits ist normalerweise 8 oder 16, wobei 16 Bit höhere Qualität
  210.               bedeuten.
  211.        frequenz gibt die Ausgabefrequenz an; höhere Werte sind besser.
  212.               Üblich sind 22050 oder 44100 Hz.
  213.        min und max geben die Größe des Soundpuffers an. Normalerweise
  214.               beträgt die Größe 8192 Bytes; auf schnellen Maschinen
  215.           können kleinere Werte Sinn machen.
  216.  
  217. Speicher-Optionen
  218.  -s n    : n*256K Slow-Memory emulieren (Adresse 0xC00000). Das Zeug, was
  219.            unten in den A500 reingesteckt wird. Manche Programme brauchen es,
  220.        obwohl haufenweise anderer Speicher vorhanden ist.
  221.  -F n    : n MB Fast-Memory emulieren (Adresse 0x200000). Das Zeug, was beim
  222.            A500 außer Festplatten in die Seite gesteckt wird.
  223.  -Z n    : n MB Zorro III-Fast-Memory emulieren. Funktioniert nur in der
  224.            68020-Emulation, erlaubt aber groessere Speicherbereiche (bis zu
  225.        64 MB)
  226.  -c n    : n*512K Chip-Memory. Sollte man nicht ändern müssen, standardmäßig
  227.            werden 2MB Chip emuliert.
  228.  
  229. Debugging-Optionen:
  230.  -D      : Nicht die Emulation, sondern den eingebauten Debugger starten.
  231.  -i      : Ungültige Speicherzugriffe anzeigen.
  232.  -g      : Teile des Betriebssystems emulieren. Dies ist noch nicht sehr
  233.            stabil und wenig empfehlenswert.
  234.  
  235. Anzeige-Options:
  236.  -H mode : Anzahl der Farben, in der UAE den Bildschirm darstellen soll,
  237.            wählen
  238.  -O mode : Bildschirmuflösung einstellen (s.u.)
  239.  -U n    : n MB Grafikkartenspeicher emulieren. Mit dieser Option wird der
  240.            Support fuer Picasso96-Grafikkarten eingeschaltet. Diese Option
  241.        funktioniert nur mit der 68020-Emulation.
  242.  
  243. Der "mode"-Parameter der Option "-O" wird wie folgt angegeben:
  244. -O Breite:Höhe:Tuning-Parameter
  245. wobei Breite und Höhe die Dimensionen des Fensters (oder den Grafikmodus)
  246. angeben. Die Tuning-Parameter bestehen aus einzelnen Buchstaben, die
  247. angegeben werden können (aber nicht müssen):
  248.   l: Schaltet Lores-Darstellung ein, nur jedes zweite horizontale Pixel wird
  249.      gezeichnet. Sinnvoll für kleine VGA-Auflösungen wie etwa 320x200.
  250.   x,y,X,Y: Wenn "x" angegeben wird, versucht UAE, das dargestellte Bild an
  251.      der richtigen Stelle am Bildschirm darzustellen. Dies ist nur nötig,
  252.      falls die Breite des Fensters weniger als 800 Pixel beträgt (etwa in
  253.      640er oder 320er-Modi). Ohne "x" wird das Bild normalerweise über den
  254.      rechten oder linken Bildschirmrand herausragen. "y" tut dasselbe für die
  255.      vertikale Richtung, es ist nur bei Fenstern nötig, die weniger als 300
  256.      Pixel hoch sind. Werden Großbuchstaben für diese Optionen verwendet
  257.      (X oder Y), so versucht UAE, besonders clever zu sein (aber da ich
  258.      Computern nicht sehr viel Cleverness zutraue, gibt's auch die dummen
  259.      Varianten).
  260.   d: Verdoppelt jede Zeile. Dafür sollte das Fenster dann mindestens 600
  261.      Zeilen hoch sein. Der Vorteil ist, daß Interlace-Screens besser
  262.      dargestellt werden (aber es läuft auch langsamer).
  263.   c: Quetscht das Amiga-Bild so, daß es mit den gewählten Dimensionen des
  264.      Fensters so gut wie möglich übereinstimmt.
  265.      
  266. Beispiel: "-O 320:200:lXYc" ist der kleinste sinnvolle Modus. Durch das "c"
  267. werden Amiga-Screens, die 320x256 Pixel groß sind, durch Weglassen einzelner
  268. Zeilen auf 320x200 gestaucht (ohne "c" werden keine Zeilen zwischendurch
  269. weggelassen, es fehlt dann einfach der untere Rand des Bildes).
  270. Die größte sinnvolle Auflösung ist "-O 800:600:d", dazwischen gibt es
  271. verschiedene sinnvolle Einstellungen, etwa "-O 640:480:X" oder auch 
  272. "-O 640:480:XYdc". Am besten, Sie experimentieren ein wenig damit.
  273.  
  274. Farb-Modi:   0 (256 Farben); 1 (32768 Farben); 2 (65536 Farben)
  275.              3 (256 Farben, allerdings gerastert um die Qualität zu
  276.             verbessern (ist etwas langsamer als Modus 0)
  277.          4 (16 Farben, gerastert); 5 (16 Millionen Farben)
  278.  
  279.  
  280. Häufige Probleme
  281. ================
  282.  
  283. Manche Kickstart-ROM-Versionen (aus neueren A4000 und A1200) sind für den
  284. 68020 compiliert, der von UAE derzeit noch nicht 100% emuliert wird, daher
  285. laufen diese Kickstarts nicht.
  286.  
  287. Auf manchen Linux-Systemen ist ein kaputter Linker installiert. Falls Sie
  288. Fehlermeldungen der Sorte "final link failed: Bad value" beim Compilieren
  289. kriegen, sollten Sie sich von sunsite.unc.edu:/pub/Linux/GCC eine neuere
  290. Version der binutils besorgen. Allerdings sollten Sie die Hinweise, die in den
  291. "release.*"-Dateien stehen, genau beachten.
  292.  
  293.  
  294. Adresse des Autors
  295. ==================
  296.  
  297. crux@pool.informatik.rwth-aachen.de
  298.  
  299. oder mit der gelben Post:
  300.  
  301. Bernd Schmidt
  302. Schloßweiherstraße 14
  303. 52072 Aachen
  304.  
  305. (bitte nicht anrufen, wenn's geht)
  306.  
  307. Wenn Sie Verständnisprobleme mit diesem Text haben oder Teile der englischen
  308. Dokumentation nicht verstehen, versuchen Sie bitte, jemand in Ihrer Nähe zu 
  309. finden, der Ihnen die Dinge erklären/übersetzen kann. Ich kann nicht jedem 
  310. Computerneuling noch einmal lang und breit erklären, wie man (beispielsweise) 
  311. CrossDOS bedient: dazu gibt's bei CrossDOS auch eine Dokumentation. Ich
  312. versuche, zu helfen, aber manche Dinge sind zu zeitaufwendig.
  313.  
  314. Bevor Sie eine Frage stellen, überprüfen Sie bitte, ob sie nicht in der
  315. Dokumentation bereits beantwortet wird.
  316. Ich verschicke keine Kickstart-ROM-Dateien oder Amiga-Spiele. Schicken Sie
  317. mir bitte auch keine Raubkopien, ich lösche so etwas sofort. Generell gilt
  318. auch, daß Sie keine Dateien, die größer als 50KB sind, per email verschicken
  319. sollten. Wenn ich 3MB Screenshots oder ähnliches Zeug per email kriege, freue
  320. ich mich nicht darüber.
  321.